Skip to content

U6 選ぶ順の組と替えるかの判断(#3604 #3864) - #4039

Merged
takemi-ohama merged 4 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u6-decide
Nov 22, 2026
Merged

takemi-ohama merged 4 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u6-decide

Conversation

@takemi-ohama

@takemi-ohama takemi-ohama commented Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

概要

実装の単位 U6「選ぶ順の組と替えるかの判断」(実装計画の Task 10)。

  • account_decide.py: Guards・group・order・guard・after_auth を足し、Usage・before_limit・after_limit を変える
  • accounts.usages: Usage を窓ごとの値(5 時間・7 日の使用率と 7 日のリセットの時刻)で返す
  • observe.py: tool_pending・turn_done を足す
  • wrapper.py・cli.py: 判断の関数の呼び方をシグネチャに合わせる(見回りの配線は U9)
  • contracts/limits.json: relay.five-hour-guard・relay.weekly-prefer・relay.weekly-guard を足し、relay.usage-guard を消す

満たす受け入れ条件: 3864:4(カットポイント)・3864:5(判断)・I12(判断)

実装の中で決めたこと

  • ラッパーの今の候補: 起動できる候補(account_choice.candidates)は U8、従量の接続の候補(fallbacks)は U11a が渡す。それまでラッパーは、読めた使用率の行の名前を candidates に、空の一覧を fallbacks に渡す(_on_switch・_limit_pick)。閾値は Settings.usage_threshold を Settings.guards(account_decide.Guards)に替え、cli.py が limits.json の 3 つから作る
  • 旧い 1 つのキャッシュ(usage.json): ラッパーの今の呼び手のために残る読みの _usage も、新しい形の欄(five・seven・seven_resets_at。無ければ None)を読む。U9 で消える
  • fallbacks の「今の種類を除く」: 今の起動先と同じ名前を除くと読んだ(key:k1 の失敗で key:k2 へ替える設計の例と合う)
  • 7 日の使用率: seven_day(過ぎていれば 0%)と、過ぎていないモデル別のスロットの最大の、大きいほう。どちらも無ければ None。seven_resets_at は seven_day が過ぎていなければその時刻、それ以外は None
  • order の並びの欠けた値: 7 日のリセットの時刻・7 日の使用率が分からないものは、それぞれの比べで後に置く
  • turn_done の時刻: 記録の timestamp(ISO)を Unix 秒にする。読めなければ (True, None)
  • tool_pending に assistant の記録が 1 つも無いとき: 「記録が無い」として None を返す
  • 既存のテストの直し: Usage の形の変更に合わせて期待値を直した。3 つのアカウントで替えが回るテスト(test_i15_short_switches_to_first_time_accounts_are_not_counted)は、_best の「最も空いたもの」の順を使っていたので、選ぶ順の組で同じ順(main → gmail → team)になる使用率に替えた
  • 観測のテスト: 責務が違うので tests/domains/relay/test_relay_observe.py に分けた

差分の行数: 16 files changed, 506 insertions(+), 102 deletions(-)(uv.lock・env.md を除く)

テスト

テストは CI で走らせる(.ndf/project.json の test.ci.only)。先に push したテストだけのコミット: e12d36d。実装のコミット: 4a24d2a

関連: #3604 #3864

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP

takemi-ohama and others added 4 commits November 22, 2026 00:41
受け入れ条件 3864:4(カットポイント)・3864:5(判断)・I12(判断)を縛るテストと、
observe.tool_pending・turn_done のテスト。Usage の窓ごとの形に合わせて既存のテストの期待値を直す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
account_decide に Guards・group・order・guard・after_auth を足し、Usage を窓ごとの値の形へ、
before_limit・after_limit を候補と閾値 A・B・C を受ける形へ変える。accounts.usages は窓ごとの値を返す。
observe に tool_pending・turn_done を足す。ラッパーと CLI は呼び方をシグネチャに合わせるだけ。
limits.json に relay.five-hour-guard・relay.weekly-prefer・relay.weekly-guard を足し、relay.usage-guard を消す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
範囲内に改行が無いとき rfind が -1 を返し、lo より前の断片まで 1 行として
読んで _Unsure になっていた。始まりを lo に抑え、回帰テストを足す(PR #4039 r2-1・r2-2)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4039)

終わり方: 収束した。ラウンド 3・指摘 7(直した 6・見送った 1・未解決 0)

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 4a24d2a65 full changes_required b81fa107c 送った r1-1・r1-2・r1-3・r1-4
2 b81fa107c since changes_required 44c961de2 送った r2-1・r2-2
3 44c961de2 since converged — — —

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:264 従来の usage.json は name・percent・limited だけを持ちます。この形式を読むと five と seven が両方とも None になり、limited が偽なら使用率 95% のアカウントも余裕の組に入ります。ラッパーのカットポイントは引き続きこのキャッシュを読むため、更新直後に従来は成立した切り替えが起きません。旧形式の行には percent を使う従来の判定を残し、旧形式のファイルをラッパーに読ませる回帰テストを追加してください。 直した —
r1-2 codex major plugins/ndf/src/ndf/domains/relay/observe.py:84 tool_pending と turn_done は、会話ログを開いたときの PermissionError や読み取り時の OSError を呼び出し元へ伝播させます。agents.tail が処理するのは FileNotFoundError だけなので、ログが読めないときに見回りを続けるための None が返りません。読み取りエラーをこの観測の境界で処理し、両関数が None を返すようにしてください。 直した —
r1-3 codex major plugins/ndf/src/ndf/domains/relay/observe.py:97 _row は途中で切れた行と JSON が壊れた完全な行を同じように読み飛ばします。例えば直近の user 行が改行付きで壊れていると、turn_done はその直前の end_turn を拾って完了を返し、子を停止する判断に古い応答が使われます。JSONL の改行で行境界を判定し、読み取り範囲の端で切れた行だけを飛ばし、完全な行の解釈に失敗した場合は安全時点を確定できないものとして None を返してください。 直した —
r1-4 codex major plugins/ndf/src/ndf/domains/relay/observe.py:84 停止可否の観測は毎回、末尾最大 256 KiB の全行を JSON として解釈して保持します。結果に必要なのが末尾の会話行と直近の assistant 以降だけの場合も、見回りのたびに過去の応答やツール出力まで再解析します。詳細設計どおり末尾から調べ、判定に必要な行を読み終えた時点で解析を打ち切ってください。 直した —
r1-5 codex major issues/issue-3604-3864-design-detail.md:630 詳細設計の SectionState.safe の説明は tool_pending・静かな時間・質問で停止可否を決める一方、_safe_point の定義は turn_done と最後の入力時刻の比較も要求しています。前者に従うと、ツール結果の後でモデルの次の推論を待っている間にも子を止められます。SectionState.safe の説明を _safe_point の判定に統一し、応答完了と最後の入力より後という条件が実装に渡るようにしてください。 見送った 基準 4(実装する人が違うものを作る設計の食い違い)に当たるが、issues/issue-3604-3864-design-detail.md は読み取り専用(-r--r--r--)にされており、承認済みの設計を固定する意図とみて権限を変えずに見送る。この PR は SectionState.safe と _safe_point をまだ実装しておらず(relay の src に該当なし)、今のコードは誤動作しない。呼び出し元への修正案: 630 行の「止めてよい時点か(呼ぶ側が observe.tool_pending・静かな時間・質問から決める)」を「止めてよい時点か(ラッパーの _safe_point の結果。子の出力が relay.quiet 止まっている・回答待ちの質問が無い・observe.turn_done が真・その応答の終わりの時刻が最後の入力(Section.input_at)より後、のすべてで真。tool_pending が偽なだけでは真にしない)」へ。併せて 844 行の tool_pending の説明に「行の境は JSONL の改行で決め、読む範囲の端で切れた行だけを飛ばす。最後の assistant の記録を読んだところで読むのを止める。読めない(OSError)・端でない完全な行が JSON でないときは None」を足すと r1-2〜r1-4 の実装と揃う。
r2-1 codex major plugins/ndf/src/ndf/domains/relay/observe.py:97 会話ログが読み取り上限を超え、読み取り範囲の先頭に前の行の断片、その直後に完了した応答があると、rfind は -1 を返します。data[prev + 1 : hi] が断片と応答を一緒に JSON として読んでしまい、turn_done が None を返すため、完了した応答での安全な切り替えを見送ります。この配置で再現しました。直前の改行が見つからない場合は lo から行を切り出し、最初の完全な行が完了した応答であるケースを回帰テストに加えてください。 直した —
r2-2 kiro major plugins/ndf/src/ndf/domains/relay/observe.py:98 _lines_backward が、範囲の始まりがファイル先頭でないとき、範囲内で最初の完全な行に切れた先頭行を混ぜて返す。data.rfind(b"\n", lo, hi) は見つからないと -1 を返すため、data[prev + 1 : hi] が data[0:hi](lo より前の切れた断片を含む)になる。json.loads が失敗して _Unsure になり、turn_done と tool_pending が None を返す。最後の assistant の行が範囲内の最初の完全な行のときや、assistant が見つからないまで最初の完全な行まで遡ったときに、止めてよい時点を確定できない。追加テストはこの経路を通らない。prev が lo 未満のときは lo - 1 として扱い、最初の完全な行に当たるテストを足す。 直した —

@takemi-ohama
takemi-ohama marked this pull request as ready for review November 22, 2026 01:02
@takemi-ohama
takemi-ohama merged commit cafe15a into sprint/3604-3864-relay-accounts Nov 22, 2026
34 checks passed
@takemi-ohama
takemi-ohama deleted the impl/3604-u6-decide branch November 22, 2026 01:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant